home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / Apple II / Essentials / Essentials.sea / File.Type.Notes / FTN.5A.XXXX < prev    next >
Encoding:
Text File  |  1993-06-15  |  2.8 KB  |  55 lines  |  [TEXT/GEOL]
  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. File Type:       $5A (90)
  7.  
  8. Full Name:       Application Configuration file
  9. Short Name:      Configuration file
  10.  
  11. Written by:      Matt Deatherage                                     May 1992
  12.  
  13. Files of this type and auxiliary type contain configuration or preferences.
  14. _____________________________________________________________________________
  15.  
  16.  
  17. Files of type $5A contain configuration information or preferences for Apple
  18. II software.  The original name for this file type is "Configuration," but
  19. it's friendlier to call such application-specific settings "preferences."
  20. It's easier for most people to understand--most people don't "configure"
  21. things often, but everyone has their own preferences.
  22.  
  23. Any program can have preferences, although it's most common for applications.
  24. However, inits, DAs and other system components can have preferences as
  25. well--see the DTS Sample Code "IR 2.0.1" for an example of an init with a
  26. preferences file.
  27.  
  28. Apple strongly recommends requesting a preferences auxiliary type if you
  29. create preferences files, so that other programs may identify your files (even
  30. if they don't operate on them).  However, if your files are named something
  31. very self-explanatory (such as the Sound Control Panel's "Sound.Settings"
  32. file), you may use auxiliary type $0000 provided you always identify your
  33. files by file name.
  34.  
  35. Preferences files belong in the same directory as the program that owns them
  36. unless the program is on a network file server, in which case the preferences
  37. should go in the user folder.  If you don't use the user folder, each user has
  38. to have write permission to the application folder (not always practical), and
  39. even so all users would have to use the same preferences.  For GS/OS
  40. applications, proper preference management is easy--using the "@" prefix puts
  41. your files exactly where they should go.  It's a little trickier for
  42. non-applications, but the AppleShare-specific call GetUserPath makes it not
  43. too difficult.  The previously-mentioned Sample Code (IR 2.0) shows how an
  44. init written in 65816 assembly language can place preference files properly.
  45.  
  46. Even if you do this, for registration and future identification purposes, we
  47. recommend you get an auxiliary type assignment.  If you intend to identify
  48. your files by name and give them a self-explanatory name, you may request with
  49. your assignment that no custom File Type Descriptor string be included with
  50. the system software, which will save disk space and memory.
  51.  
  52. Note that using auxiliary type $0000 when identifying preferences by name is
  53. an exception to the normal rule--in other file types, you may NOT use
  54. auxiliary type $0000.
  55.